home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / graphic / viewers / general / msdos / ncsa / docs / pcshow.doc
Encoding:
Text File  |  1989-04-22  |  26.6 KB  |  1,107 lines
  1.  
  2.  
  3.  
  4.     
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20. NCSA PC Show 
  21. for the IBM PC, XT, AT, and PS/2
  22.  
  23. Version 1.0
  24.  
  25.  
  26. January 1989
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57. University of Illinois at Urbana-
  58. Champaign
  59.  
  60. NCSA PC Show Version 1.0 program and 
  61. documentation are in the public domain. 
  62. Specifically, we give to the public domain 
  63. all rights for future licensing of the 
  64. program, all resale rights, and all 
  65. publishing rights.
  66.  
  67. We ask, but do not require, that the 
  68. following message be included in all derived 
  69. works:  Portions developed at the National 
  70. Center for Supercomputing Applications at the 
  71. University of Illinois at Urbana-Champaign.
  72.  
  73.  
  74. User Feedback        READ ME NOW
  75.  
  76. If you want to see more software like NCSA PC 
  77. Show,  send us a letter, email or US mail, 
  78. telling us what you are doing with NCSA PC 
  79. Show. We need to know:  1) What science you 
  80. are working onPan abstract of your work would 
  81. be fine; and 2) How NCSA PC Show has helped 
  82. you, for example, by increasing your 
  83. productivity or allowing you to do things you 
  84. could not do before.
  85.  
  86. We encourage you to cite the use of NCSA PC 
  87. Show, and any other NCSA software you have 
  88. used, in your publications. A bibliography of 
  89. your work would be extremely helpful.
  90.  
  91. NOTE:  This is a new kind of shareware. You 
  92. share your science and successes with us, and 
  93. we can get more resources to share more 
  94. software like NCSA HDF with you.
  95.  
  96.  
  97. NCSA Contacts
  98.  
  99. Mail all manual suggestions to:     Mail user 
  100. feedback, software     suggestions and bugs 
  101. to:
  102.  
  103.  
  104. NCSA Documentation     NCSA Software 
  105. Development
  106. 152 Computing Applications Bldg     152 
  107. Computing Applications Bldg.
  108. 605 E. Springfield Ave.     605 E. Springfield 
  109. Ave. 
  110. Champaign, IL 61820     Champaign, IL 61820
  111.  
  112. The email addresses are:    The email addresses 
  113. are:
  114.  
  115. pubs@ncsa.uiuc.edu    bugs@ncsa.uiuc.edu
  116. pubs@ncsavmsa.bitnet    bugs@ncsavmsa.bitnet
  117.  
  118.  
  119. Disclaimer
  120.  
  121. THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, 
  122. EXPRESS OR IMPLIED, FOR THE SOFTWARE AND/OR 
  123. DOCUMENTATION PROVIDED, INCLUDING, WITHOUT 
  124. LIMITATION, WARRANTY OF MERCHANTIBILITY AND 
  125. WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE.
  126.  
  127.  
  128. Trademark Acknowledgments
  129.  
  130. Enhanced Graphics Adapter, Video Graphics 
  131. Adapter, IBM PC, PC/AT, Personal System/2, 
  132. and PC-DOS are registered trademarks of 
  133. International Business Machines Corporation.
  134. Revolution 512 is a trademark of Number Nine 
  135. Computer.
  136.  
  137. i    NCSA PC Show
  138.  
  139. Table of Contents    i
  140.  
  141. National Center for Supercomputing Applications
  142.  
  143. January 1989
  144.  
  145.                                                                 
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.     Table of Contents
  155.  
  156.  
  157.  
  158.  
  159. Introduction
  160. Overview  vi
  161. About PC Show  vi
  162. Special Features  vi
  163. System Requirements  vi
  164. Use of This Manual  vi
  165.  
  166. Chapter 1    Entering and Exiting NCSA PC Show
  167. Chapter Overview  1.1
  168. Starting PC Show  1.1
  169. Exiting PC Show  1.2
  170.  
  171. Chapter 2    Viewing Images with NCSA PC Show
  172. Chapter Overview  2.1
  173. Displaying Multiple Images 2.1
  174. Animations in PC Show  2.2
  175.  
  176. Chapter 3    Palettes and Palette Manipulations
  177. Chapter Overview  3.1
  178. What is a Palette?  3.1
  179. Palette Manipulation Command Keys  3.2
  180. Tables and Figures
  181. Table 1.1    Command Line Parameters  1.2
  182. Table 2.1    General Image Command Keys  2.2
  183. Table 3.1    Manipulation Command Keys  3.2
  184. Figure 2.1    General Help Screen  2.3
  185. Figure 2.2    Image Help Screen  2.4
  186. Figure 3.1    Palette Help Screen  3.4
  187.  
  188. i    NCSA PC Show
  189.  
  190. Introduction    i
  191.  
  192. National Center for Supercomputing Applications
  193.  
  194. January 1989
  195.  
  196.                                                                 
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. Introduction
  205.  
  206.  
  207.  
  208.  
  209.  
  210. Overview
  211.  
  212. This introduction provides an overview of 
  213. NCSA PC Show. The organization and use of 
  214. this manual are described and notational 
  215. conventions are explained.
  216.  
  217.  
  218. About PC Show
  219.  
  220. NCSA PC Show Version 1.0 displays images with 
  221. the Enhanced Graphics Adapter (EGA), the 
  222. Video Graphics Adapter (VGA), or the 
  223. Revolution 512 graphics card from Number Nine 
  224. Computer (NO9). PC Show can display either 
  225. binary raster images or images contained in 
  226. HDF files.
  227.  
  228.  
  229. Special Features
  230.  
  231. Special Features of PC Show include
  232.  
  233. %    display of multiple images in sequence,
  234. %    display of HDF formatted files or binary 
  235. raster files,
  236. %    display with EGA, VGA, or NO9 video 
  237. controllers,
  238. %    manipulations of palette while image is 
  239. displayed,
  240. %    simultaneous storage of multiple palettes, 
  241. and
  242. %    animation of multiple image sequences.
  243.  
  244.  
  245. System Requirements
  246.  
  247. In order to run NCSA PC Show, you need the 
  248. following hardware:
  249.  
  250. %    IBM PC, PC/AT, or IBM PS/2 with one of the 
  251. following graphics controller boards:  
  252. Enhanced Graphics Adapter, Video Graphics 
  253. Adapter, or Revolution 512
  254.  
  255. %    320K memory for PC Show
  256.  
  257. PC-DOS or MS-DOS Version 2.0 or later must 
  258. also be installed on the machine before PC 
  259. Show is run.
  260.  
  261.  
  262. Use of This Manual
  263.  
  264. .c3.Organization 
  265. of This Manual
  266. This manual is organized into three chapters. 
  267. Each page of each chapter is given a unique 
  268. number that consists of the chapter number, a 
  269. period, and the number of that individual 
  270. page (beginning with the first page of the 
  271. chapter). For example, page 2.3 is the third 
  272. page of the second chapter. Each chapter is 
  273. divided into sections, and some sections are 
  274. divided into subsections.
  275.  
  276.  
  277. .c3.Manual 
  278. Contents
  279. This manual is organized into the following 
  280. chapters and appendices:
  281.  
  282. Chapter One, "Entering and Exiting NCSA PC 
  283. Show," provides a brief discussion of the 
  284. commands used to begin PC Show, command line 
  285. parameters which enable special display 
  286. options, and methods of exiting the program.
  287.  
  288. Chapter Two, "Viewing Images In NCSA PC 
  289. Show," delineates the various commands which 
  290. concern the display of animations or multiple 
  291. images. The chapter contains tables which 
  292. depict two of the online help screens 
  293. featured by PC Show.
  294.  
  295. Chapter Three, "Palettes and Palette 
  296. Manipulations," describes both the 
  297. characteristics of various palettes and the 
  298. commands which permit the manipulation of 
  299. palettes.
  300.  
  301.  
  302. .c3.Typographic 
  303. Conventions in 
  304. This Manual
  305. Commands shown in courier boldface type 
  306. represent a user entry. Program lists and 
  307. screen displays are presented in courier 
  308. type.
  309.  
  310. Explanations of software display often 
  311. include a printed representation of the 
  312. screen display. These displays are shown in 
  313. courier type.
  314.  
  315. Keynames are shown in capital, boldface 
  316. letters when it is intended that you press 
  317. them; for example, "Press ENTER to advance 
  318. to the Palette Help Screen."
  319.  
  320. In descriptions of the various features and 
  321. commands, a word or phrase that is used for 
  322. the first time may be shown in italics. A 
  323. definition or explanation of the term 
  324. follows.
  325. 1.1    NCSA PC Show
  326.  
  327. Entering and Exiting NCSA PC Show    1.1
  328.  
  329. National Center for Supercomputing Applications
  330.  
  331. January 1989
  332.  
  333.                                                                 
  334.  
  335.  
  336.  
  337. 1.1    NCSA PC Show
  338.  
  339. Entering and Exiting NCSA PC Show    1.1
  340.  
  341. National Center for Supercomputing Applications
  342.  
  343. January 1989
  344.  
  345.                                                                 
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352. Chapter 1    Entering and Exiting NCSA PC Show
  353.  
  354.  
  355.  
  356. Chapter Overview
  357. Starting PC Show
  358. Examples of Starting PC Show
  359. Exiting PC Show
  360.  
  361. Chapter Overview
  362.  
  363. This chapter provides a brief discussion of 
  364. the commands used to begin NCSA PC Show, 
  365. command line parameters which enable special 
  366. display options, and methods of exiting the 
  367. program.
  368.  
  369.  
  370. Starting PC Show
  371.  
  372. To simply display an HDF file on an EGA 
  373. monitor, enter a command of the form:
  374.  
  375. C:\ > pcshow filename
  376.  
  377. Then press ENTER and the image(s) in the HDF 
  378. file will appear on the monitor.
  379.  
  380. To display a binary raster image, you must 
  381. specify additional command line parameters. 
  382. Table 1.1 lists the additional parameters and 
  383. their functions. The command to display a 
  384. binary raster image on the EGA monitor takes 
  385. the following form:
  386.  
  387. C:\ > pcshow -b xdim ydim -m 
  388. palettefile filename
  389.  
  390. where xdim and ydim are the dimensions of 
  391. the image in pixels, palettename is the 
  392. name of the palette you wish to have the 
  393. image shown with, and filename is the name 
  394. of the file containing the list of image 
  395. files to be displayed. It is important to 
  396. include the parameters when using binary 
  397. files; otherwise, the screen will remain 
  398. black and no image may be viewed.
  399.  
  400. These commands are sufficient to run PC Show 
  401. using an EGA monitor. Special display options 
  402. become available when additional command line 
  403. parameters are specified. Chapters 2 and 3 
  404. discuss these options. Table 1.1 below lists 
  405. the optional parameters.
  406.  
  407.  
  408. Table 1.1  Command Line Parameters
  409.  
  410. Parameter    Type    Function
  411.  
  412. -v    Hardware    Specifies VGA video controller 
  413. card.
  414.  
  415. -e    Hardware    Specifies EGA video controller 
  416. card
  417.         (Default Value).
  418.  
  419. -9    Hardware    Specifies NO9 video controller 
  420. card.
  421.  
  422.  
  423. Table 1.1  Command Line Parameters (continued)
  424.  
  425. Parameter    Type    Function
  426.  
  427. -b xdim ydim    File Format    Specifies a list of binary 
  428. file images
  429.         contained in the parameter. 
  430. (All the binary         files must have x and y 
  431. dimensions             identical to those 
  432. given in this command         line.)
  433.  
  434. -m palettefile    File Format    Specifies the name of the 
  435. palette file to be         used with binary files.
  436.  
  437. -h    File Format    Indicates that the images are 
  438. stored in HDF         format files.
  439.  
  440. -c    Screen Location    Centers the image on 
  441. the screen.
  442.  
  443. -p xloc yloc    Screen Location    Labels an x, y 
  444. coordinate on the screen for         the upper-left hand 
  445. corner of the image.
  446.  
  447. -a    Miscellaneous    Specifies that the HDF file of 
  448. the images or         the binary files in the list 
  449. are to be shown as         an animation, one image after 
  450. another         until all the images have been 
  451. displayed.
  452.  
  453. -s    Miscellaneous    Specifies that the filename 
  454. parameter for         binary files is actually the 
  455. filename of the         image, rather than the name 
  456. for a file         containing a list of the image 
  457. filenames.
  458.  
  459.  
  460. Examples of 
  461. Starting PC Show
  462. Suppose you have a list of binary images of 
  463. the dimensions 256 by 320 in a file named 
  464. image.lst. In order to display the images 
  465. using the palette test.pal and centering them 
  466. on a VGA monitor screen, you would enter the 
  467. command:
  468.  
  469. C:\ > pcshow -b 256 320 -v -c -m 
  470. test.pal image.lst
  471.  
  472. In order to display only a single binary 
  473. file, you need to use the -s parameter. For 
  474. example, if you wish to display on a NO9 
  475. monitor a single binary file named image.pic 
  476. of the dimensions 320 by 512 with the palette 
  477. test.pal, you would enter:
  478.  
  479. C:\ > pcshow -s -9 -m test.pal -b 320 
  480. 512 image.pic
  481.  
  482. If an animation is to be depicted, then the 
  483. filename parameter must be a file containing 
  484. the image names or an HDF file. Also, all the 
  485. images to be animated must be of the same 
  486. dimensions; otherwise, they will be distorted 
  487. upon display. To display an animation of a 
  488. binary sequence of images contained in the 
  489. file named image.lst, you would enter:
  490.  
  491. C:\ > pcshow -a -v -m pic.pal -b 320 
  492. 320 image.lst
  493.  
  494.  
  495. Exiting PC Show
  496.  
  497. To exit the program, type q while the image 
  498. is displayed on the screen. The program 
  499. displays the next image in the HDF file or 
  500. the next image on the list of binary images. 
  501. If the current image is the last or only 
  502. image, the program returns to DOS.
  503.  
  504. If you type q after viewing the final image 
  505. and are not returned to DOS, press CONTROL-C 
  506. to exit the program. If CONTROL-C does not 
  507. exit the program, re-boot the computer. 
  508. Please use the Bugs and Suggestions report 
  509. form at the back of this manual to report any 
  510. problems to NCSA, in order that they may be 
  511. remedied in future releases of NCSA PC Show.
  512.  
  513. 2.1    NCSA PC Show
  514.  
  515. Viewing Images with NCSA PC Show    2.1
  516.  
  517. National Center for Supercomputing Applications
  518.  
  519. January 1989
  520.  
  521.                                                                 
  522.  
  523.  
  524.  
  525. 2.1    NCSA PC Show
  526.  
  527. Viewing Images with NCSA PC Show    2.1
  528.  
  529. National Center for Supercomputing Applications
  530.  
  531. January 1989
  532.  
  533.                                                                 
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540. Chapter 2    Viewing Images with NCSA PC Show
  541.  
  542.  
  543.  
  544. Chapter Overview
  545. Displaying Multiple Images
  546. Animations in PC Show
  547. General Image Commands
  548. Online Help Screens
  549. Scrolling Through the Image
  550.  
  551. Chapter Overview
  552.  
  553. This chapter delineates the various commands 
  554. which concern the display of animations or 
  555. multiple images. The chapter contains tables 
  556. which depict two of the online help screens 
  557. featured by PC ShowPthe General Help Screen 
  558. and the Image Help Screen.
  559.  
  560.  
  561. Displaying Mutiple Images
  562.  
  563. The multiple image function of PC Show 
  564. assumes that the images reside either as 
  565. multiple images inside an HDF file or as 
  566. members of a list in a file of image names of 
  567. a binary file.
  568.  
  569. For example, to display on a NO9 monitor the 
  570. HDF file images.hdf, which contains multiple 
  571. images, enter:
  572.  
  573. C:\ > pcshow -9 images.hdf
  574.  
  575. Notice that the command line to display 
  576. multiple images from an HDF file does not 
  577. differ from the command line to display a 
  578. single image from an HDF file. This is one 
  579. advantage of storing your images in HDF 
  580. files.
  581.  
  582. To display on an EGA monitor multiple images 
  583. from a binary file named images.1st of the 
  584. dimensions 256 by 320 with the palette 
  585. test.pal, enter:
  586.  
  587. C:\ > pcshow -b 256 320 -m test.pal 
  588. images.1st
  589.  
  590. when the file images.1st is a list of the 
  591. binary images to be displayed, one image name 
  592. per line. Such an image listing file should 
  593. resemble the list below:
  594.  
  595. myimage1.256
  596. myimage2.256
  597. testimage.256
  598. lastimage.256
  599.  
  600. You may wish to make the extension of your 
  601. image file the width of the image, as the 
  602. example above demonstrates, to prompt your 
  603. memory.
  604.  
  605. The first image in the file is automatically 
  606. displayed after entering the command to 
  607. execute PC Show. After the first image is 
  608. viewed, it is possible to modify the palette 
  609. or the image using the commands listed on the 
  610. help screens. To quit viewing the current 
  611. image and view the next image in the file, 
  612. type q. This will cause PC Show to advance 
  613. automatically to the next image. In this 
  614. manner, all the images in the file may be 
  615. viewed once. To repeat viewing of any image 
  616. re-execute PC Show.
  617.  
  618.  
  619. Animations in PC Show
  620.  
  621. The following sections present the various 
  622. animation and manipulation command keys in PC 
  623. Show and describe their functions.
  624.  
  625.  
  626. General Image 
  627. Commands
  628. Table 2.1 lists general commands that deal 
  629. with the image itself. They do not concern 
  630. the actual location of the image on the 
  631. screen.
  632.  
  633. Table 2.1
  634.     General 
  635. Image     Command 
  636. Keys
  637. Command Key    Function
  638.  
  639. i    Displays information concerning 
  640. the current     image or animation being 
  641. displayed. The     information shown 
  642. includes:  the current x     and y coordinates 
  643. of the upper-left corner of     the image, the 
  644. x and y dimensions of the     image, and 
  645. indicates that the image is part of     an 
  646. animation and the mouse is activated, if 
  647.     such is the case.
  648.  
  649. a    Runs the animation sequence 
  650. again. If the     current image is not part of 
  651. an animation     sequence, the command is 
  652. invalid, and will     have no effect.
  653.  
  654. k    Causes PC Show to treat the 
  655. current image as     merely a single image 
  656. and to eliminate     further animation. If 
  657. the current image is not     part of an 
  658. animation sequence, the command     is 
  659. invalid.
  660.  
  661. o    Toggles the VGA screen off and 
  662. on. Does not     affect other types of monitors.
  663.  
  664. NOTE:  Turning the VGA screen on or off 
  665. affects neither the actual operations of the 
  666. software, nor the retention of information 
  667. concerning the image or its display upon the 
  668. screen.
  669.  
  670. q    Displays the next image in the 
  671. HDF file, or     the next image in the list of 
  672. binary file     names. In either case, if the 
  673. current image is     the last, the program 
  674. returns to DOS.
  675.  
  676. m    Activates or deactivates the 
  677. mouse if one is     present.
  678.  
  679. /    Slows down animation.
  680.  
  681. *    Speeds up animation.
  682.  
  683. Table 2.1
  684.     General 
  685. Image     Command 
  686. Keys 
  687.     (Continued
  688. )
  689. Command Key    Function
  690.  
  691. ,    Asks for the upper-left and 
  692. right hand corner
  693. (comma)    coordinates and magnifies the 
  694. image to fill     the screen.
  695.  
  696.  
  697. Online Help 
  698. Screens
  699. Three online help screens are available 
  700. during program executionPthe General Help 
  701. Screen, the Palette Help Screen, and the 
  702. Image Help Screen. To view the General Help 
  703. Screen, press ? while the image is displayed 
  704. on the monitor. When you press ?, PC Show 
  705. enters the sequence of help screens. To 
  706. advance through the help screens, press 
  707. ENTER; pressing any other key returns to the 
  708. image display. For easy reference, the 
  709. General Help Screen is presented in Figure 
  710. 2.1.
  711.  
  712. Figure 2.1  
  713. General 
  714. Help Screen
  715.  
  716. i    Shows Information About The 
  717. Image
  718. a    Shows Animation Again
  719. k    Ends Animation Mode
  720. o    Toggles VGA Screen Off Or On
  721. q    Exits Viewing Image Or Animation
  722. ?    Shows This Help Sequence
  723. m    Activates/Deactivates Mouse
  724. /    Slows Down Animation Speed
  725. *    Speeds Up Animation Speed
  726. ,    Asks For Upper Left Hand Corner 
  727. And     Lower Right Hand Corner 
  728. Coordinates Of     An Area On The Screen To 
  729. Magnify To     Fill The Screen.
  730.  
  731. PC Show does not accept commands that are 
  732. entered while you are viewing the help 
  733. screen. Help screen commands are valid only 
  734. while you are viewing the image. To continue 
  735. viewing the image, press any key but ENTER. 
  736. If you press ENTER, PC Show advances to the 
  737. Palette Help Screen.
  738.  
  739.  
  740. Scrolling 
  741. Through the 
  742. Image
  743. Due to the limited size of video monitors, 
  744. often only portion of an image is displayed 
  745. on the screen. To allow viewing of an entire 
  746. image, scrolling functions are available. 
  747. Figure 2.2 lists the scrolling functions as 
  748. they are listed in the Image Help Screen.
  749.  
  750. Figure 2.2  
  751. Image Help 
  752. Screen
  753.  
  754. left arrow    Moves Image Left Ten Pixels
  755. up arrow    Moves Image Up Ten Pixels
  756. down arrow    Moves Image Down Ten Pixels
  757. right arrow    Moves Image Right Ten Pixels
  758. page up    Pages Up A Full Screen On The 
  759. Image
  760. page down    Pages Down A Full Screen On 
  761. The     Image
  762. home    Moves To The Upper Left Hand 
  763.     Corner Of Image
  764. end    Moves To The Lower Right Hand 
  765.     Corner Of Image
  766. x    Inputs X And Y Coordinates For 
  767.     Upper Left Hand Corner
  768.  
  769. This help screen is only accessible by 
  770. entering the command ? and pressing ENTER 
  771. twice to pass both the General Help Screen 
  772. and the Palette Help Screen.
  773.  
  774. 3.1    NCSA PC Show
  775.  
  776. Palettes and Palette Manipulations    3.1
  777.  
  778. National Center for Supercomputing Applications
  779.  
  780. January 1989
  781.  
  782.                                                                 
  783.  
  784.  
  785.  
  786. 3.1    NCSA PC Show
  787.  
  788. Palettes and Palette Manipulations    3.1
  789.  
  790. National Center for Supercomputing Applications
  791.  
  792. January 1989
  793.  
  794.                                                                 
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801. Chapter 3    Palettes and Palette Manipulations
  802.  
  803.  
  804.  
  805. Chapter Overview
  806. What is a Palette?
  807. Palette Manipulation Command Keys
  808.  
  809. Chapter Overview
  810.  
  811. This chapter describes the characteristics of 
  812. various palettes and the commands which 
  813. permit manipulation of palettes. The online 
  814. Palette Help Screen is also depicted for easy 
  815. reference.
  816.  
  817.  
  818. What is a Palette?
  819.  
  820. A palette is a group of data used by the 
  821. computer to determine how the data in the 
  822. image file is to be mapped to the set of 
  823. available colors. The palette is arranged in 
  824. memory as three separate arrays, each of 256 
  825. bytes of character data. Each of the arrays 
  826. represents one of the color components of the 
  827. palettePred, green, or blue. Entries in each 
  828. component array range from 0 to 255. The 
  829. smaller values correspond to lighter shades 
  830. and larger values correspond to darker 
  831. shades. The color displayed on the video 
  832. screen is a combination of red, green, and 
  833. blue shades from individual component arrays 
  834. indexed by the value of the data from the 
  835. image file.
  836.  
  837. The Revolution 512 board by Number Nine 
  838. Computers provides a full 256 shades of red, 
  839. green, and blue for each of the 256 entries 
  840. in the palette. The VGA board by IBM provides 
  841. only 64 shades of red, green, and blue for 
  842. each of the 256 entries in the palette. The 
  843. EGA board provides the same 64 shades of red, 
  844. green, and blue, but the palette is limited 
  845. to only 16 entries.
  846.  
  847. Because the EGA palette is limited to only 16 
  848. colors, and most image information has 256 
  849. colors, an algorithm is required to convert 
  850. between the two. This method uses a frequency 
  851. count to find the colors occurring most often 
  852. in the image data, and assigns their values 
  853. to the first 16 entries in the palette. In 
  854. this fashion, the image is displayed in only 
  855. the 16 most popular colors contained in the 
  856. data.
  857.  
  858. Many of the PC Show command keys intended to 
  859. modify the palette will not work properly for 
  860. an image which is displayed on an EGA 
  861. monitor. If the command fails, pressing the 
  862. command key will not affect the palette. The 
  863. command keys that modify the palette are 
  864. presented in the following section.
  865.  
  866. The palette is arranged in memory as three 
  867. separate arrays of 256 bytes of character 
  868. data corresponding to each color component. 
  869. These arrays are modified in various ways by 
  870. the palette manipulation command keys.
  871.  
  872. NOTE:  Unless otherwise noted, it is assumed 
  873. that succeeding command keys will modify all 
  874. components of the palette in the same manner.
  875.  
  876.  
  877. Palette Manipulation Command Keys
  878.  
  879. Table 3.1 lists the command keys that 
  880. manipulate the palette.
  881.  
  882. Table 3.1    Manipulation     Command Key    Function    
  883.     Command Keys
  884. f        Rotates the palette. The 
  885. second entry             replaces the 
  886. first, the first entry replaces the     
  887.     zeroth, the zeroth the 255th, and 
  888. so forth,         until all the entries 
  889. are moved down one         increment. 
  890. This continues until the         
  891.     SPACE BAR is pressed. You may 
  892. control the         speed of the rotation 
  893. using the + and -         command keys.
  894.  
  895. b        Performs the same function as 
  896. the f             command key, except that 
  897. it rotates the         palette in the 
  898. opposite direction. The speed of         the 
  899. rotation may be controlled using the + 
  900.         and - keys.
  901.  
  902. +        Increases the speed of the 
  903. rotation of the         palette when the 
  904. continuous rotation             commands 
  905. are operating.
  906.  
  907. -        Decreases the speed of the 
  908. rotation of the         palette when the 
  909. continuous rotation             commands 
  910. are operating.
  911.  
  912. space bar        Stops the rotation of 
  913. the palette only when the     
  914.     continuous rotation commands are 
  915.             operating. Also stops 
  916. animations in mid-        sequence.
  917.  
  918. e        Rotates the palette forward 
  919. one increment.
  920.  
  921. v        Rotates the palette backward 
  922. one increment.
  923.  
  924. r        Resets the current palette to 
  925. the default         values defined when it 
  926. was read in. This         command will affect 
  927. all palette             manipulations which 
  928. have been performed.         You may make 
  929. the current palette the         default 
  930. palette by pressing the command         key 
  931. d.
  932.  
  933.  
  934. Table 3.1    Manipulation    Command Key    Function
  935.     Command Keys
  936.     (Continued)    c        Toggles the color bar on or 
  937. off. Displays the                 current palette in the 
  938. lower-left hand corner                 of the screen. The 
  939. palette is represented as a                 color bar of 
  940. continuous values from 0 to 255                 from left to 
  941. ight.This is useful for observing                 the effects of 
  942. various palette manipulations                 and does not change 
  943. the image underneath                 the palette.
  944.  
  945. l        Reads a new palette from the 
  946. disk. If an         HDF file is in use, then 
  947. another palette is         read from that 
  948. file. If     binary files are         being 
  949. used, then a palette file name is     
  950.     requested.
  951.  
  952. n        Advances the current palette 
  953. to the next         palette stored in 
  954. memory. If the current         palette is the 
  955. last one in memory, this         command 
  956. advances to the first palette in     
  957.     memory.
  958.  
  959. s        Stores the current palette in 
  960. the HDF file if         one is in use, or 
  961. requests a file name for the         current 
  962. palette. The convention for         
  963.     assigning names to a palette is to 
  964. append the         palette name with .pal.
  965.  
  966. u        Exchanges the red, green, and 
  967. blue             components of the 
  968. current palette in the         following 
  969. fashion:  the red component is     
  970.     replaced by the green component, 
  971. the green         component is replaced by 
  972. the blue             component, and the blue 
  973. component is         replaced by the red 
  974. component.
  975.  
  976. t        Exchanges the entries in the 
  977. palette end for         end.That is, the 
  978. last entry is exchanged         with the 
  979. first, the next to last is exchanged     
  980.     with the second, and so on through 
  981. the         palette.
  982.  
  983. g        Takes the binary value for 
  984. each of the         components and inverts 
  985. it bit by bit; thus, a         dark red 
  986. becomes a light red and black         becomes 
  987. white.
  988.  
  989. Table 3.1    Manipulations    Command Key    Function
  990.     Command Keys
  991.     (Continued)    h        Invokes the fiddle mode. In 
  992. this mode, you                 can use the arrow keys 
  993. modify the palette in                 the following way:  
  994. up or down movement                 compresses or 
  995. expands the palette, and left                 or right movement 
  996. shifts the palette left or                 right. To view the 
  997. help screen that lists the                 fiddle command 
  998. keys, press ?. The fiddle                 mode command is not 
  999. available for EGA                 graphics mode.
  1000.  
  1001. d        Replaces the default palette 
  1002. in memory with         the current 
  1003. palette. You should store the         modified 
  1004. palette before loading or switching     
  1005.     palettes in order to prevent loss 
  1006. of the             modifications made.
  1007.  
  1008. p        Moves the color bar on the 
  1009. screen. Prompts         you to enter the 
  1010. upper-left hand corner         coordinates of 
  1011. the color bar.
  1012.  
  1013. For easy reference, the Palette Help Screen 
  1014. which displays the commands associated with 
  1015. manipulating the palette is shown in Figure 
  1016. 3.1. You can only access this help screen by 
  1017. entering the command ? and pressing ENTER to 
  1018. pass by the General Help Screen. To return to 
  1019. the image, press any key but ENTER. Pressing 
  1020. ENTER advances to the Image Help Screen.
  1021.  
  1022.  
  1023. Figure 3.1  
  1024. Palette 
  1025. Help Screen
  1026.  
  1027. f    Rotates Palette Continuously 
  1028. Forward
  1029. b    Rotates Palette Continuously 
  1030. Backward
  1031. +    Speeds Up Palette Rotation
  1032. -    Slows Down Palette Rotation
  1033. space bar    Stops Palette Rotation
  1034. e    Rotates Palette Once Forward
  1035. v    Rotates Palette Backward
  1036. r    Resets Palette To Initial 
  1037. Settings
  1038. c    Toggles Color Bar On Or Off The 
  1039. Screen
  1040. l    Loads In A New Palette
  1041. n    Shows Next Palette In Memory
  1042. s    Stores Current Palette On Disk
  1043. v    Swaps Red, Green, And Blue 
  1044. Components     Of Palette
  1045. t    Transposes Palette
  1046. g    Inverts Palette Bitwise
  1047. h    Enters Fiddle Mode
  1048. d    Makes Current Palette The 
  1049. Default     Palette
  1050. p    Moves Position Of The Color Bar
  1051.  
  1052. BUGS AND SUGGESTIONS
  1053.  
  1054. Please notify us of any bugs you have found 
  1055. in our software and any suggestions you have 
  1056. for future releases or products.
  1057.  
  1058. Using the report form below, mail user 
  1059. feedback, software suggestions, or bugs to:
  1060.  
  1061. NCSA Software Development
  1062. 152 Computing Applications Bldg.
  1063. 605 E. Springfield Ave. 
  1064. Champaign, IL 61820
  1065.  
  1066. Send reports regarding bugs via electronic 
  1067. mail to:
  1068.  
  1069. bugs@ncsa.uiuc.edu
  1070. bugs@ncsavmsa.bitnet
  1071.  
  1072. Send reports regarding software suggestions 
  1073. or comments via electronic mail to:
  1074.  
  1075. softdev@ncsa.uiuc.edu
  1076.  
  1077.  
  1078. REPORT FORM
  1079. Name:
  1080.  
  1081. Institution:
  1082.  
  1083.  
  1084.  
  1085. Address (Electronic)
  1086.  
  1087.  
  1088.  
  1089. Address (U.S. Mail)
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095. Telephone:   (          )            P
  1096.  
  1097. Version of NCSA PC Show:
  1098.  
  1099. Type machine:
  1100.  
  1101.  
  1102. Version of system software:
  1103.  
  1104.  
  1105. Suggestion or description of problem:
  1106.  
  1107.